package com.baoyouqun.service;

import com.alibaba.cola.dto.SingleResponse;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baoyouqun.domain.Query.LeopardFriendPageQuery;
import com.baoyouqun.domain.VO.CellphoneDuplicateVO;
import com.baoyouqun.domain.VO.LeopardFriendDetailVO;
import jakarta.servlet.http.HttpServletResponse;

import java.io.IOException;

/**
 * 豹友管理独立Service（专注分页、导出、手机号校验等管理功能）
 */
public interface LeopardFriendManageService {

    /**
     * 分页查询豹友列表（适配页面展示）
     *
     * @param query 分页查询条件
     * @return 分页VO结果
     */
    SingleResponse<IPage<LeopardFriendDetailVO>> pageLeopardFriend(LeopardFriendPageQuery query);

    /**
     * 导出豹友列表（适配Excel）
     *
     * @param query    导出筛选条件
     * @param response Http响应（用于输出Excel流）
     * @throws IOException 流操作异常
     */
    void exportLeopardFriend(LeopardFriendPageQuery query, HttpServletResponse response) throws IOException;

    /**
     * 检查手机号重复（返回重复豹友详情）
     *
     * @param cellphone 待校验手机号
     * @return 重复校验结果（含重复用户列表）
     */
    SingleResponse<CellphoneDuplicateVO> checkCellphoneDuplicate(String cellphone);
}